home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / program / misc / phn-mape.lha / phn-mapedit.doc < prev    next >
Text File  |  1995-09-28  |  4KB  |  131 lines
  1.  
  2. ************************
  3.  
  4. Phantasm Map Editor v1.1
  5.  
  6. ************************
  7.  
  8. Written by Frank Wille in March 1994
  9. Released in September 1995
  10.  
  11. email: frank@phoenix.owl.de
  12.  
  13.  
  14.  
  15. 1. Introduction
  16. ===============
  17.  
  18. PHN-MapEdit is a tool for editing the block-map of multidirectional
  19. scrolling games. It supports 16x16 pixel blocks up to 32 colors. The
  20. map dimensions are unlimited and depend on your available memory only.
  21. MapEdit reads and writes raw map files with each byte representing a
  22. 16x16 block of your map. Hence the number of different block images,
  23. defined by an IFF-ILBM file, is limited to 256.
  24.  
  25. MapEdit was written in C with extensive usage of "game.lib" (© 1992
  26. by Frank Wille). Because of the nature of game.lib, which was mainly
  27. designed for games, the user interface is not very style-guide con-
  28. form, but the program supports all OS versions, CPUs and custom chips
  29. (but no gfx-cards).  Multitasking is not disabled, but the system's
  30. copper lists, so you can't bring the WB screen to front while editing.
  31.  
  32.  
  33.  
  34. 2. Copyright
  35. ============
  36.  
  37. PHN-MapEdit is FREEWARE!
  38.  
  39.  
  40.  
  41. 3. Installation
  42. ===============
  43.  
  44. To run PHN-MapEdit you may copy the three files
  45.  
  46. PHN-MapEdit
  47. mapedit7.fnt
  48. cursor.spr
  49.  
  50. whereever you want.
  51.  
  52.  
  53.  
  54. 4. Using MapEdit
  55. ================
  56.  
  57. To start with editing, you need at least a block image file, in the form
  58. of an IFF-ILBM picture. The picture dimensions are absolutely irrelevant.
  59. Gaps between the block images are allowed, but a row of blocks must not
  60. end with a partial block. If the block doesn't fit into the current row,
  61. put it into the next one. You may refer to "blkimgs.iff" as an example.
  62.  
  63. The map file has the raw format:  UBYTE map[HEIGHT][WIDTH];
  64.  
  65.  
  66. 4.1. A sample session
  67. ---------------------
  68.  
  69. Warning: Don't expect a comfortable file requester, you will be forced
  70.      to remember the needed file names... ;)
  71.  
  72. The following steps are required, to edit the example map:
  73.  
  74. 1. Start PHN-MapEdit.
  75.  
  76. 2. You will be asked to enter the map dimensions. Enter:
  77.    WIDTH:  120
  78.    HEIGHT: 120
  79.  
  80. 3. Now MapEdit requires the names of the map and the block image file:
  81.    MAP FILE NAME:   examplemap.120.120
  82.    ILBM FILE NAME:  blkimgs.iff
  83.  
  84. 4. NUMBER OF IMAGES: 220
  85.    This is the number of block images, which will be used by the editor.
  86.    It is allowed to specify more than your picture actually contains -
  87.    then you will get some empty blocks additionally.
  88.  
  89. 5. IMAGE GAP:         1
  90.    The gap between the block images (horizontal and vertical) is one
  91.    pixel in this case. 'freditor' images use a zero gap, for example.
  92.  
  93. 6. Now the files will be read and checked. Hit a key to start with
  94.    editing...
  95.  
  96.  
  97. 4.2. Editor functions
  98. ---------------------
  99.  
  100. Mouse control:
  101.  
  102. o Move the mouse without pressing a button to move the cursor
  103. o Pressing the left mouse button plots the currently selected block
  104.   into the map
  105. o Holding the right mouse button by moving the mouse left or right
  106.   lets you select another block image
  107.  
  108. Keyboard:
  109.  
  110. Esc - Exit the program without saving. No security check!
  111. F1 - Saves your map file. The program continues.
  112. F6 - Init map. The whole map is initialized with your current block
  113.      image.
  114. F7 - Standard fill. All blocks which have the same image and have a
  115.      connection with the block under your cursor are replaced by the
  116.      current block image.
  117. F8 - Quad fill. Same as above, but four preselected (F10) block images
  118.      will be used for filling.
  119. F10 - Quad fill preselect. You will be prompted for four block images,
  120.       which will be used in quad fill (F8). They are arranged as
  121.       follows, when filling:
  122.        ---------------
  123.       | first | second|
  124.       |       |       |
  125.        ---------------
  126.       | third | fourth|
  127.       |       |       |
  128.        ------- -------
  129. SPACE - Overview. Computes an overview map with the size 1:8. It will
  130.     also inform you about the current cursor coordinates.
  131.